Instructions for Use

1. Develop Your Story: Use an LLM to outline your narrative. As mentioned earlier, ensure it is a filmable story.

2. Extract Assets: Attach extract_assets.txt and input your story script to generate a structured asset list in JSON format.

3. Generate Asset References: Attach the corresponding asset generation TXT file and feed in each asset's description to generate reference images. Feel free to tweak the descriptions manually as needed.

4. Run the Director Agent: Attach Director_agent.txt and provide your story script, the JSON asset list from Step 2, and any optional directorial notes. The agent will then generate the full storyboard breakdown alongside precise video prompts for each scene.

	- Model Requirements: Because this step is complex, it requires an LLM with a large context window, strong reasoning capabilities, and fast performance. Model selection matters here—a model like Gemini 3.6 Flash with thinking mode enabled is ideal for handling the depth of the analysis.

	- Timing & Parameters: Note that generation may take a little longer due to the depth of the reasoning process. Before executing, open Director_agent.txt to adjust your timing parameters: [singleSceneDuration] (maximum duration per clip) and [totalDuration] (total project duration). Set these according to your video model's limits—most cap at 15 seconds per clip, whereas models like Seedance 2.5 can handle up to 30 seconds.

5. Generate Video Clips: Input the corresponding asset reference images and video prompts into your video model to produce the individual scene clips.




# example input of Director Agent:

[story content]
# Echoes in the Rain

A woman in a yellow trench coat stands under the glowing sign of a neon-lit ramen shop on a rain-slicked city street. Streetlights reflect off wet pavement, casting a blue and orange glow across her face. Steam rises from a nearby sewer grate, swirling around her ankles as rainwater drips from the rim of her umbrella. She glances down at her leather wristwatch, fingers softly tapping the strap.

Across the street, a man steps out of a dark alley holding a small, paper-wrapped bouquet of white lilies. He pauses at the edge of the curb, wiping rain from his forehead with the back of his sleeve. He catches sight of the yellow coat. A slow smile opens across his face, and he steps off the curb into the crosswalk, walking toward her.

A sudden gust of wind sweeps down the avenue, snatching the umbrella from her hand. It tumbles into the street, rolling across the wet asphalt toward an oncoming bus. The man surges forward, extending a hand to catch the umbrella before it rolls under the tires. His foot slips on the slick metal of a drainage grate, and he drops the bouquet as he stumbles to one knee.

The white lilies fall directly into a deep puddle, soaking instantly in muddy rainwater.

The woman runs over to him, reaching down to take his hand and pulling him up. He looks down at the ruined flowers, shaking his head. She smiles, reaches out, and pulls a single, dry lily petal that had caught on the lapel of his jacket. She holds it up between her fingers, smiling up at him as rain pours over both of them.

[assets list]
{
	"locations": [
		{
			"id": 0,
			"name": "Neon-Lit City Street",
			"image_prompt": "A rain-slicked urban city street at night, glowing neon sign of a ramen shop, streetlights reflecting vibrant blue and orange light on wet asphalt, steam rising from a metal sewer grate, rain pouring down, dark alleyway across the crosswalk, drainage grate at the curb."
		}
	],
	"characters": [
		{
			"id": 0,
			"name": "Woman in Yellow Trench Coat",
			"image_prompt": "Human woman, late 20s, slim build, shoulder-length brown hair, soft facial features, wearing a bright yellow trench coat and a leather wristwatch."
		},
		{
			"id": 1,
			"name": "Man with Bouquet",
			"image_prompt": "Human man, late 20s, athletic build, short dark hair, sharp facial features, dressed in a dark jacket."
		}
	],
	"props": [
		{
			"id": 0,
			"name": "Bouquet of White Lilies",
			"image_prompt": "Paper-wrapped bouquet, fresh white lilies with delicate yellow stamens, wrapped in simple brown butcher paper."
		},
		{
			"id": 1,
			"name": "Umbrella",
			"image_prompt": "Standard handheld rain umbrella, curved handle, dark fabric canopy, light metal ribs."
		}
	]
}
